package cn.vehicle.service;

import cn.vehicle.domains.bo.QueryUserBo;
import cn.vehicle.domains.entity.SysUserEntity;
import cn.vehicle.domains.info.UserInfo;

import java.util.List;

/**
 * 系统用户服务接口
 * <p>
 * 定义系统用户管理的核心业务操作，包括用户的新增、修改、删除、查询及角色权限加载。
 * 该接口作为业务层与持久层之间的抽象层，为用户模块提供统一的服务访问规范。
 * </p>
 *
 * <p>主要职责：</p>
 * <ul>
 *   <li>封装用户表（sys_user）的基础增删改查逻辑；</li>
 *   <li>支持根据用户名、ID等方式查询用户；</li>
 *   <li>提供加载用户角色与权限的功能。</li>
 * </ul>
 */
public interface SysUserService {

    // 定义系统用户相关的核心业务方法

    /**
     * 新增系统用户
     *
     * @param sysUserEntity 用户实体对象，包含用户名、密码、角色等信息
     */
    void addUser(SysUserEntity sysUserEntity);

    /**
     * 根据ID查询用户信息
     *
     * @param id 用户主键ID
     * @return 用户实体对象
     */
    SysUserEntity getUserById(Long id);

    /**
     * 更新用户信息
     *
     * @param updateEntity 更新的用户实体对象，需包含主键ID
     */
    void updateUser(SysUserEntity updateEntity);

    /**
     * 删除用户
     *
     * @param id 用户主键ID
     */
    void deleteUser(Long id);

    /**
     * 查询用户列表
     *
     * @param queryUserBo 查询条件封装对象
     * @return 用户实体列表
     */
    List<SysUserEntity> selectUserList(QueryUserBo queryUserBo);

    /**
     * 根据用户名查询用户信息
     *
     * @param username 用户名
     * @return 用户实体对象
     */
    SysUserEntity getUserByUsername(String username);

    /**
     * 查询用户的角色与权限信息
     *
     * @param userId 用户主键ID
     * @return 用户信息对象，包含角色与权限列表
     */
    UserInfo getUserRoleAndPermission(Long userId);


}
